SHEPHERD
Code Management Tool for PowerBuilder Applications

March 31, 1997

This document outlines the main features of the product, installation and start up guidelines.

What is SHEPHERD
----------------

SHEPHERD is a PowerBuilder code management tool written using PowerBuilder ORCA interface. 

SHEPHERD enhances the ability of the developers to understand the structure of PowerBuilder objects and analyze impact of possible code changes.

SHEPHERD is designed by application architects and "field tested" as indispensable tool in the course of development and maintenance of many large scale projects dealing with thousands of objects. 
SHEPHERD analyzes objects of ANY size and complexity
SHEPHERD deals with applications containing ANY number of objects

SHEPHERD API allows to build Powerbuilder tools such as application generators, code analyzers, version control systems, etc.

Requirements
------------
PowerBuilder 4 or 5 Enterprise Edition for Windows 3.1x or Windows NT/95 is required.  

Shepherd is capable of working with applications written in PowerBuilder 3, 4 and 5. Therefore it expects to find the appropriate installation of PowerBuilder 3,4 and/or 5 Enterprise Edition.

Installation and Start-up Notes
-------------------------------
SHEPHERD is distributed as four zipped files:
SH4_16.ZIP - Shepherd built with PowerBuilder 4 for Windows 3.1
SH4_32.ZIP - Shepherd built with PowerBuilder 4 for Windows NT/95
SH5_16.ZIP - Shepherd built with PowerBuilder 5 for Windows 3.1
SH5_32.ZIP - Shepherd built with PowerBuilder 5 for Windows NT/95

1. Unzip the file into the empty directory. 
2. Start SHEPHERD.EXE. 
3. Click on File/Open menu item. 
4. Select the PowerBuilder application using the FileOpen dialog. SHEPHERD remembers four last applications and objects you have worked with - so next time you can open applications and/or objects using File menu and selecting one of the most recently opened applications or objects 

If SHEPHERD complains that it cannot find ORCA DLL
--------------------------------------------------
We equipped SHEPHERD with enough intelligence to find ORCA DLL. But we cannot be sure that it will do that in all possible PowerBuilder installation scenarious. If you receive error message stating that SHEPHERD cannot find ORCA DLL please copy SHEPHERD.EXE, PBD(PB4 version only), HLP, INI and DLL files to the directory where respective ORCA DLL is located.

Shepherd Lite Setup
-------------------
Shepherd Lite allows to analyze PowerBuilder objects one at a time. To invoke Shepherd Lite from one of the custom PowerBuilder toolbar icons follow these steps:

1.  Include a new toolbar icon by checking the Custom radiobutton in PowerBuilder Customize toolbar dialog
2.  Select an icon from the Selected Palette list of stock icons, drag it to the Current Toolbar
3.  Specify <shepherd installation directory>\SHEPLITE.EXE in Command Line field.
4.  Type Shepherd Lite in Item Text entry field. Click on OK button. Shepherd Lite is set up.
5.  If you would like to analyze and/or modify the PowerBuilder object using Shepherd simply click on icon you have selected. Open Object dialog will open. Enter or paste the name of the object you would like to work with. 

Shepherd Lite identifies the object type based on the first letter of the object name following the "standard" naming convention accepted in many PowerBuilder shops. Correct the object type if necessary. Uncheck the Auto Library Select checkbox if you want to point to the library the required object should be found in. Otherwise Shepherd will scan the entire library list searching for the required object 

Shepherd Lite automatically recognizes the application the PowerBuilder is working with and sets the necessary environment. 

Shepherd API
------------
Shepherd API definitions and manual are in SH_API16/32.HLP files. We decided to distribute these along with standard version of SHEPHERD. To begin use it without any limitation on number of libraries and objects you have to register and receive the authorization code from us. You can give it a try without valid authorization number - in demonstration mode. Just remember that in the demonstration mode you will not be able to work with more than 8 libraries and 16 objects.

File  List
----------
SHEPHERD.EXE 
SHEPLITE.EXE 
SHEPHERD.PBD (for Shepherd built with PB4 only)
SHPHRD16.DLL or SHPHRD32.DLL 
SHEPHERD.HLP
SH_API16.HLP or SH_API32.HLP
SHEPHERD.INI
STUB.DLL
REGISTER.TXT
README.TXT - This file


Feedback and Technical Support
------------------------------
Please forward any comments and/or problems to:
105200,2110@compuserve.com, alexv@gti.net, or
73144,1655@compuserve.com

Updates and Bug Fixes
------------------------
Use www.gti.net/alexv or PBFORUM 3rd party library to get new versions and bug fixes.

Registration Information
------------------------
SHEPHERD is not freeware! We spent a great deal of time developing this product, and believe that it deserves to be paid for.
See REGISTER.TXT for registration information.

Copyright 1996,1997 Rapid Technologies, Inc.
